<html>

<head>
<meta http-equiv="Content-Language" content="en-us">
<title>ShutdownJava Task</title>
<link rel="stylesheet" type="text/css" href="../stylesheets/antmanual.css">
</head>

<body>

<h2><a name="java">ShutdownJava</a></h2>
<h3>Description</h3>
<p>Shutdown a Java class on the remote host or hosts. </p>
<p>The string 'dir + classname + classpath + args' as a key will be stored in a process repository after the command is executed on the remote host.</p>
<p>That key is a unique identifier to indicate each process started on the remote host. </p>
<p>So, to shutdown the class, you only need to provide the <strong>dir</strong>, <strong>classname</strong>, <strong>classpath</strong> and <strong>args</strong> for the specified host or hosts. </p>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
  <tr>
    <td valign="top"><b>Attribute</b></td>
    <td valign="top"><b>Description</b></td>
    <td align="center" valign="top"><b>Required</b></td>
  </tr>
  <tr>
    <td valign="top">classname</td>
    <td valign="top">the Java class to execute.</td>
    <td align="center" valign="top">Either jar or classname</td>
  </tr>
  <tr>
    <td valign="top">classpath</td>
    <td valign="top">the classpath to use.</td>
    <td align="center" valign="top">NO</td>
  </tr>
  <tr>
    <td valign="top">classpathref</td>
    <td valign="top">the classpath to use, given as <a
      href="../using.html#references">reference</a> to a PATH defined elsewhere.</td>
    <td align="center" valign="top">NO</td>
  </tr>
  <tr>
    <td valign="top">failonerror</td>
    <td valign="top">Stop the buildprocess if the command exits with a
      returncode other than 0. Default is "false" (see <a href="#failonerror">note</a>)</td>
    <td align="center" valign="top">NO</td>
  </tr>
  <tr>
    <td valign="top">hostref</td>
    <td valign="top">reference a remote host.if hostref or hostsetref both not specified, the command will execute locally </td>
    <td valign="top" align="center">NO</td>
  </tr>
  <tr>
    <td valign="top">hostsetref</td>
    <td valign="top">reference remote hosts. if hostref or hostsetref both not specified, the command will execute locally </td>
    <td valign="top" align="center">NO</td>
  </tr>
  <tr>
    <td valign="top">dir</td>
    <td valign="top">the directory name on the remote host, if it is not an absolute dir, the host's base dir will be instered before this dir. </td>
    <td valign="top" align="center">YES</td>
  </tr>
  <tr>
    <td valign="top">transmit</td>
    <td valign="top">whether or not transmit the command to the remote host, default value is YES, if set to NO, just print the command in standard output. </td>
    <td align="center" valign="top">NO</td>
  </tr>
</table>
<h3>&nbsp;</h3>
<h4>Examples</h4>
<pre>  &lt;shutdownjava dir=&quot;${resouces.dir}&quot; classname=&quot;Echo&quot; hostref=&quot;localhost&quot;&gt;<br>     &lt;arg line=&quot;abc&quot;/&gt;<br>     &lt;classpath path=&quot;${resouces.dir}&quot;/&gt;<br>  &lt;/shutdownjava&gt;</pre>
<hr>
<p align="center">Copyright &copy; 2005 Dant Organization. All rights Reserved.</p>

</body>
</html>

